AppDimens SDP, HDP, WDP: Scalable Width and Height Dimensions/com.appdimens.dynamic.code.perimeter/PerimeterSp

PerimeterSp

class PerimeterSp(val initialBaseValue: Number, val defaultFontScale: Boolean = true, val sortedCustomEntries: List<CustomSpEntry> = emptyList(), val ignoreMultiWindows: Boolean = false, val applyAspectRatio: Boolean = false, val customSensitivityK: Float? = null)

EN A class that allows defining custom Sp text dimensions based on screen qualifiers (UiModeType, Width, Height, Smallest Width).

The value is resolved using a Context and uses the base value or a custom value, applying dynamic scaling.

PT Classe que permite definir dimensões de texto Sp customizadas baseadas em qualificadores de tela (UiModeType, Largura, Altura, Smallest Width).

Constructors

PerimeterSp

private constructor(initialBaseValue: Number, defaultFontScale: Boolean = true, sortedCustomEntries: List<CustomSpEntry> = emptyList(), ignoreMultiWindows: Boolean = false, applyAspectRatio: Boolean = false, customSensitivityK: Float? = null)

constructor(initialBaseValue: Number)

Properties

applyAspectRatio

private val applyAspectRatio: Boolean

customSensitivityK

private val customSensitivityK: Float?

defaultFontScale

private val defaultFontScale: Boolean

ignoreMultiWindows

private val ignoreMultiWindows: Boolean

initialBaseValue

private val initialBaseValue: Number

sortedCustomEntries

private val sortedCustomEntries: List<CustomSpEntry>

Functions

aspectRatio

@JvmOverloads

fun aspectRatio(enable: Boolean = true, sensitivityK: Float? = null): PerimeterSp

EN Allow applying aspect ratio based constraint scaling. PT Permite aplicar o redimensionamento baseado na proporção da tela.

ignoreMultiWindows

@JvmOverloads

fun ignoreMultiWindows(ignore: Boolean = true): PerimeterSp

EN Allow ignoring the constraint scaling based on multi-window resizing properties. PT Permite ignorar o dimensionamento para os layouts de múltiplas janelas (divisão de tela).

prhem

fun prhem(context: Context): Float

prhsp

fun prhsp(context: Context): Float

prsem

fun prsem(context: Context): Float

EN Resolve final value in pixels (WITHOUT font scale).

prsemPrhemPrwemPx

fun prsemPrhemPrwemPx(context: Context): Triple<Float, Float, Float>

EN Resolves prsem, prhem, and prwem in one pass (fixed Sp / no font-scale path). PT Resolve prsem, prhem e prwem numa só passagem (Sp fixo / sem escala de fonte).

prssp

fun prssp(context: Context): Float

EN Resolve final value in pixels (WITH font scale).

prsspPrhspPrwspPx

fun prsspPrhspPrwspPx(context: Context): Triple<Float, Float, Float>

EN Resolves prssp, prhsp, and prwsp in one pass (single UiModeType.fromConfiguration read). PT Resolve prssp, prhsp e prwsp numa só passagem.

prwem

fun prwem(context: Context): Float

prwsp

fun prwsp(context: Context): Float

reorderEntries

private fun reorderEntries(newEntry: CustomSpEntry): List<CustomSpEntry>

EN Adds a new entry and re-sorts the list by priority, then by qualifier value (descending).

resolvePx

private fun resolvePx(context: Context, qualifier: DpQualifier, fontScaleOverride: Boolean? = null): Float

EN Resolves qualifier to px using the first matching CustomSpEntry, optionally overriding font scale. PT Resolve qualifier em px usando a primeira CustomSpEntry correspondente, com override opcional da escala de fonte.

resolvePxInternal

private fun resolvePxInternal(context: Context, qualifier: DpQualifier, configuration: Configuration, currentUiModeType: UiModeType, fontScaleOverride: Boolean?): Float

EN Shared implementation for resolvePx, prsspPrhspPrwspPx, and prsemPrhemPrwemPx. PT Implementação compartilhada para resolvePx, prsspPrhspPrwspPx e prsemPrhemPrwemPx.

screen

@JvmOverloads

fun screen(orientation: Orientation = Orientation.DEFAULT, customValue: Number, finalQualifierResolver: DpQualifier? = null, inverter: Inverter = Inverter.DEFAULT, fontScale: Boolean = defaultFontScale): PerimeterSp

EN Priority 4: orientation only. PT Prioridade 4: apenas orientação.

@JvmOverloads

fun screen(type: UiModeType, customValue: Number, finalQualifierResolver: DpQualifier? = null, orientation: Orientation = Orientation.DEFAULT, inverter: Inverter = Inverter.DEFAULT, fontScale: Boolean = defaultFontScale): PerimeterSp

EN Priority 2: UiModeType only (e.g. TELEVISION, WATCH). PT Prioridade 2: apenas UiModeType (ex.: TELEVISION, WATCH).

@JvmOverloads

fun screen(type: DpQualifier, value: Int, customValue: Number, finalQualifierResolver: DpQualifier? = null, orientation: Orientation = Orientation.DEFAULT, inverter: Inverter = Inverter.DEFAULT, fontScale: Boolean = defaultFontScale): PerimeterSp

EN Priority 3: Dp qualifier (sw, h, w) without UiModeType restriction. PT Prioridade 3: qualificador Dp (sw, h, w) sem restrição de UiModeType.

@JvmOverloads

fun screen(uiModeType: UiModeType, qualifierType: DpQualifier, qualifierValue: Number, customValue: Number, finalQualifierResolver: DpQualifier? = null, orientation: Orientation = Orientation.DEFAULT, inverter: Inverter = Inverter.DEFAULT, fontScale: Boolean = defaultFontScale): PerimeterSp

EN Priority 1: Most specific qualifier — combines UiModeType and Dp qualifier (sw, h, w). PT Prioridade 1: qualificador mais específico — combina UiModeType e qualificador Dp (sw, h, w).